Application settings

This topic describes the application settings, default solution settings, and default user settings, as well as a list of placeholders. The 'default solution' settings will be used for every newly created solution (saved to JewelSuite Geomechanics File or DMS). These settings are then stored in the solution. The 'application settings' and 'user settings' are used every time the JewelSuite Geomechanics application is started.

Application configurations

The ApplicationConfigurations section of the configuration file contains those settings that are configurable in the configuration file (for example JewelSuiteGeomechanics.dll.config), and are overridable by settings in sub-configurations. The following settings are part of these application settings:

<ApplicationConfigurations>
  <ApplicationConfiguration key="FactoryUserSettings" value="./Configurations/FactoryUserSettings.xml" />
  <ApplicationConfiguration key="LithologyDictionary" value="./Configurations/LithologyDictionary.xml" />
  <ApplicationConfiguration key="PropertyDictionary" value="./Configurations/PropertyDictionary.xml" />
  <ApplicationConfiguration key="ColorSetDictionary" value="./Configurations/ColorSetDictionary.xml" />
  <ApplicationConfiguration key="PropertyCalculatorDictionary" value="./Configurations/PropertyCalculatorDictionary.xml" />
  <ApplicationConfiguration key="UnitSystemDictionary" value="./Configurations/UnitSystemDictionary.xml" />
  <ApplicationConfiguration key="BlueMarbleGeoDataFile" value="" />
  <ApplicationConfiguration key="DefaultDmsServers" value="dmsserverurl" />
  <ApplicationConfiguration key="AllowCustomCrs" value="true" />
  <!-- Optional: -->
  <ApplicationConfiguration key="DefaultLoginBrowser" value="EDGE" />
</ApplicationConfigurations>
  • BlueMarbleGeoDataFile - The BlueMarble geodata.xml file installed with the application is used by default. To use a custom data file, set the path in the BlueMarbleGeoDataFile setting.
  • DefaultDmsServers - The entered value 'dmsserverurl' is the URL of the DMS server that the JewelSuite user will see listed in the drop-down list on the Connect to DMS form. It can be a comma-separated list to include multiple DMS servers, for example https://dms.company.com.
  • DefaultLoginBrowser - The browser used for authentication inside the JewelSuite application. Accepted values are EDGE and CHROME. If this key is not present, EDGE is used by default.

The above keys and values are also the default settings that apply when a key/value pair is not present or specified.

Solution settings

SolutionSettings contains the default settings for (new) JewelSuite solutions. These settings can be overridden by sub-configurations.

  • UserSettingsPath - The default path of the user settings is what is set to the Environment.SpecialFolder.UserProfile\AppData\Local\{CompanyName}. If Environment.SpecialFolder.UserProfile is not setup on the machine, then the default path is set to the path where the executable is located. The default settings filename follows the following template: UserSettings.{applicationName}.{majorVersion}.{minorVersion}.json

    For example: C:\Users\smitjoh\AppData\Local\Baker Hughes, the filename is UserSettings.JewelSuiteGeomechanics.2026.3.json

  • CubicFeetOfGasForOneBarrelOfOilEquivalent - Default value: 5800.464037. To change this value, modify the 'Gas to Boe conversion factor' field on the Constants form (home > Settings).

User settings

UserSettings section contains those settings that are user-specific and which can be overridden by sub-configurations. It stores the settings that you can change in the home > Settings > Options button group.

  • UserDisplayName - This setting is used on various reports generated with the application. The default value is the username. With this setting you can change the default, for example instead of username ‘smitjoh' the name 'John Smith’ can be used. Note that this is a shared setting among all users using the same computer.
  • UserColorSetDictionaryFilePath - The default value is the path Environment.SpecialFolder.UserProfile\AppData\Local\{CompanyName}\{CultureInfo.CurrentUICulture.Name}\ColorSetDictionary.xml when UserProfile available. Otherwise the path where the executable is located\{CultureInfo.CurrentUICulture.Name}\ColorSetDictionary.xml.
  • MaxMostRecentUsedSolutions - This setting defines the amount of JewelSuite Geomechanics Files that the application remembers you have had open and saved in previous sessions.
  • CustomTempFolder - JewelSuite Geomechanics applications store temporary files used by the application while running. With this setting you can change the default path to the temporary files, which is pointing to the Temp directory in AppData. In order to use the custom temp folder you need to set the UseCustomTempFolder to true.
  • UseCustomTempFolder - This setting enables/disables the usage of the custom temp folder. True if the 'CustomTempFolder' setting is used, otherwise false.

In the AdditionalSettings section, the settings of add-ins are listed.

Placeholders

The following placeholders can be used in the Application settings (ApplicationConfigurations), User settings (DefaultUserConfigurations), and Solution settings (DefaultSolutionConfiguration). When you add one of these placeholders to the 'value' of a setting, it is replaced with the actual value when JewelSuite starts.

For example, when you use %ApplicationShortName%, it is replaced with the text 'JewelSuite Geomechanics' when you start JewelSuiteGeomechanics.exe.

  • %ApplicationName%
  • %ApplicationShortName%
  • %SupportUrl%
  • %SupportEmailAddress%
  • %ProductName%
  • %ProductVersion%
  • %Copyright%
  • %ApplicationPath%
  • %CompanyName%
  • %BatchServerExecutableName%
  • %BatchServerInstallFolder%